sequenceDiagram
  autonumber
  actor User
  participant Client as MCP Client App
  participant SSE as SSE Transport
  participant Server as Elicitation Server (MCPApp)
  participant Upstream as Upstream Client (Elicitation)

  Note over Client,Server: Elicitation flow: confirm_action
  User->>Client: Initiate confirm_action("proceed")
  Client->>SSE: send tool.call(confirm_action)
  SSE->>Server: deliver request
  Server->>Server: Build schema (ConfirmBooking)
  alt Upstream elicitation available
    Server->>Upstream: elicit(schema, prompt)
    Upstream-->>Server: {"confirm": true|false, "notes": "..."}
  else Local handler available
    Server->>Server: app.context.elicitation_handler(...)
    Server-->>Server: result
  else No elicitation channels
    Server->>Server: default decision
  end
  Server-->>SSE: return result string
  SSE-->>Client: tool.result
  Client-->>User: Display result

sequenceDiagram
  autonumber
  participant Client as Notifications Client
  participant SSE as SSE Transport
  participant Server as Notifications Server (MCPApp)
  participant Upstream as Upstream Session

  Note over Client,Server: Notifications tools (best-effort)
  Client->>SSE: call notify("hello", "info")
  SSE->>Server: invoke notify
  Server->>Server: app.logger.info("hello")
  Server-->>SSE: "ok"
  Client->>SSE: call notify_progress(0.5, "Halfway")
  SSE->>Server: invoke notify_progress
  alt Upstream available
    Server->>Upstream: send_progress_notification(token, 0.5, "Halfway")
    Upstream-->>Server: ack
    Server-->>SSE: "ok"
  else Missing upstream
    Server->>Server: log warning
    Server-->>SSE: "no-upstream"
  end

sequenceDiagram
  autonumber
  participant Client as Sampling Client
  participant SSE as SSE Transport
  participant Server as Sampling Server (MCPApp)
  participant LLM as Augmented LLM

  Note over Client,Server: sample_haiku(topic)
  Client->>SSE: call sample_haiku("mountains")
  SSE->>Server: invoke tool
  Server->>LLM: generate_str("Haiku about mountains", params)
  LLM-->>Server: "three-line haiku..."
  Server-->>SSE: return string
  SSE-->>Client: tool.result